Help FreeCAD/ru

Вступление

Если вам нравится FreeCAD и вы хотите помочь проекту, вы можете сделать многое, независимо от того, хотите ли вы инвестировать время или деньги, умеете ли вы писать код или нет.

Пожертвуйте деньги

Хотя FreeCAD не нуждается в деньгах для развития, пожертвования могут помочь проекту развиваться дальше и быстрее. На странице пожертвовать перечислены все возможные варианты пожертвования денег на проект.

Работа над документацией

Помогите нам составлять, корректировать и расширять документацию. Исправляйте ошибки, расширяйте или исправляйте непонятные страницы, создавайте новые страницы, если тема упущена, и так далее. Внести свой вклад в развитие вики FreeCAD просто, на WikiPages вы найдёте общие рекомендации, необходимые для начала перевода. Для редактирования вики вам понадобится вики-аккаунт с правами «Редактора» (вики защищена от записи во избежание спама). Вы можете запросить учетную запись на форуме или на канале IRC. Но учтите, что канал IRC может быть не так отзывчив, как форум. Официальный форум FreeCAD должен быть главным местом для того, чтобы задавать вопросы и начинать обсуждения, это поможет сохранить опыт и знания сообщества.

Несколько областей, которые ждут вашей помощи:

• На странице Category:Command Reference перечислены и документированы все команды FreeCAD. Большинство из них содержат мало или вообще никакой информации. Пожалуйста, обратитесь к страницам Wiki для ознакомления с примерами того, как должны выглядеть страницы документации команд.
• Секции Учебники нужны примеры того, как использовать верстаки. Если вы разработали что-то классное в FreeCAD, почему бы не задокументировать, как вы это сделали для потомков?
• На сайте FreeCAD «bug tracker» по тегу «documentation» есть открытые тикеты, которым не помешало бы немного внимания.

Поделитесь своими знаниями FreeCAD

Сообщество пользователей FreeCAD пока ещё невелико, но уже включает в себя несколько опытных пользователей, которые делают очень важную работу, показывая новичкам, как пользоваться программой. Если вы начнёте чувствовать себя комфортно в FreeCAD, ваши знания могут оказаться очень ценными для других, и вы можете внести свой вклад, предоставив такие важные материалы, как:

• Показывать работу, которую вы делаете с помощью FreeCAD, на форуме Users Showcase. Вы можете размещать скриншоты, а ещё лучше - прикреплять файлы FreeCAD, чтобы другие люди могли изучить их и понять, как вы это сделали.
• Записывать видео, показывающие, как вы сделали что-то интересное во FreeCAD. Эти видео обычно отлично демонстрируют новые возможности.
• Писать Учебные пособия, описывая или обучая чему-то интересному. Вы можете писать учебники в своём блоге, прямо на нашей вики или даже на форуме.
• Публикуйте сообщения в социальной сети с открытым исходным кодом Mastodon (и follow FreeCAD там), в сообществе Facebook или в Twitter (и follow FreeCAD здесь). Используйте хэштеги #FreeCAD, #MadeWithFreeCAD или #fc3d, чтобы ваши сообщения, связанные с FreeCAD, было легче найти другим пользователям FreeCAD.
• Просмотрите последние сообщения о FreeCAD на Reddit, 3dprinting.stackexchange, StackOverflow... Старайтесь отвечать на них и участвовать в обсуждениях, делясь своим опытом и информацией.
• Присутствуйте на IRC-канале FreeCAD или других чат-группах.

Переведите FreeCAD

Переведите FreeCAD на свой язык. Все текстовые строки интерфейса FreeCAD могут быть легко переведены на другие языки. Все, что нам нужно, это кто-то, кто знает другой язык и готов помочь! Все переводы доступны онлайн на Crowdin.

Подробнее о переводе смотри в разделе Локализация.

Переведите документацию

Переводить легко, вики FreeCAD поддерживает плагин для перевода, который позволяет переводить базовую английскую страницу на другие языки.

Подробнее о переводе см. Localisation#Translating the wiki.

Пожалуйста, убедитесь, что вы знакомы с основами вики-разметки; для справки смотрите Помощь:Редактирование.

Затем перейдите на WikiPages чтобы ознакомиться со стилем, используемым в этой вики, особенно когда речь идет о шаблонах.

Помогите другим узнать о FreeCAD

• Поговорите о FreeCAD с другими людьми, которые могут быть заинтересованы
• Найдите интересное использование FreeCAD и задокументируйте его, например, со снимками экрана. FreeCAD очень молод, и не многие люди видят, что они могут с ним сделать. Если вы уже являетесь поклонником FreeCAD, вы наверняка знаете, что может сделать FreeCAD. Помогите нам показать это другим!
• Посещайте форум, помогайте новичкам решать основные вопросы
• Пишите пособия, записывайте видео и т.д., показывающее, что вы делаете с FreeCAD
• Помогайте с файлами, чертежами и т.д. Нам все еще не хватает хороших примеров о том, что можно сделать с помощью FreeCAD
• Помогите продвинуть FreeCAD на GitHub "Starring" and "Watching" Репозиторий FreeCAD

Сообщайте об ошибках и запрашивайте интересные функции

Английский язык

Русский язык

Несмотря на то, что сообщать о выявленных ошибках и предлагать новые возможности можно в основном на FreeCAD Issue Tracker на GitHub (Трекер проблем FreeCAD на GitHub), пожалуйста, всегда сначала публикуйте сообщения об ошибках и запросы на новые возможности в разделе Помощь. Чтобы сэкономить время разработчиков (работа с труднопонимаемыми ошибками может отнимать много времени) и избежать разочарований из-за того, что ваш вопрос не был решён так, как вам хотелось бы, пожалуйста, прочитайте следующее:

• Запросы об ошибках и новых возможностях обрабатываются в одном трекере. Просто отметьте свой вопрос как ошибка (bug) (то, что не работает так, как должно) или новая функция (feature) (то, чего нет, но вы считаете, что было бы неплохо иметь).
• Хотя первоначально была возможность отправлять вопросы анонимно, к сожалению, это пришлось отменить из-за спама. Теперь, если вы хотите создавать/редактировать заявки, вам придётся создать учётную запись. По умолчанию вы будете получать уведомления, когда кто-то добавляет заметки к проблеме. Во многих случаях человеку, который будет заниматься этой проблемой, потребуется дополнительная информация от вас.
• При сообщении об ошибке наиболее важным моментом является возможность разработчиком воспроизвести её. Обязательно укажите точные шаги, необходимые для воспроизведения ошибки, чтобы другой человек мог сделать то же самое и увидеть, что ошибка произошла и на его компьютере. Если разработчик не видит ошибку, он не может её устранить.
• Также укажите информацию, которая может помочь разработчикам определить проблему: операционную систему, на которой работает FreeCAD, точную версию FreeCAD и соответствующие библиотеки. Пожалуйста, опубликуйте все данные с помощью кнопки скопировать на доску объявлений в диалоге Справка (меню) → о FreeCAD.
• Независимо от того, насколько вы уверены, что нашли ошибку, пожалуйста, всегда обсуждайте ошибки сначала на форуме Help (Помощь).
• Прежде чем отправлять запрос на добавление функции, всегда обсуждайте его с другими пользователями на форуме Open discussion forum (Форум для обсуждения открытых вопросов/запросов), так вы сможете получить более солидное предложение, у которого будет больше шансов заинтересовать разработчика в его реализации.
• Помните, что FreeCAD разрабатывается добровольцами, которые используют своё свободное время для работы над ним. Хотя каждый старается изо всех сил создать лучшее из возможных приложений, ваш отчет об ошибке может быть обработан с низким приоритетом или отменён, если вы не можете предоставить достаточно информации, а ваш запрос функции может быть отложен или даже отклонён, если ни один разработчик не заинтересован в её реализации или если это потребует нереального объёма работы.

Сортировка ошибок

Еженедельно на GitHub приходят десятки сообщений об ошибках. Требуется много времени, чтобы прочитать их, распределить по категориям, проверить, воспроизводима ли проблема, посмотреть, можно ли выполнить какие-то простые действия, или попросить человека, опубликовавшего проблему, предоставить больше информации. Помогать в сортировке очень просто, просто зайдите на GitHub и начните комментировать любые проблемы, в которых, по вашему мнению, вы могли бы помочь!

Графический Дизайн

Смотрите Каталог художественных работ, а так же Руководство по художественному оформлению чтобы узнать о том, как создавать иконки для FreeCAD.

Напишите код

Писать код для FreeCAD несложно, и вам не нужно никаких разрешений, вы можете начать прямо сейчас работать над тем, что вам нужно, а затем отправить патч на issue tracker (трекер вопросов) или запросить слияние из git branch (ветка git). Чтобы избежать головной боли, вам следует сначала выполнить следующие условия:

• Информация о том как скомпилировать FreeCAD доступна для различных операционных систем.
• Прежде чем приступить к написанию кода для FreeCAD, вы должны знать, как работает FreeCAD. Это кажется очевидным, но если вы не знаете, как он должен работать, вы не будете знать, что и как делать внутри.
• Почти все можно сделать либо на Python, либо на C ++. Внутри все работает почти одинаково на обоих языках. Мы предлагаем вам прочитать страницы в Уголке опытных пользователей, даже если вы собираетесь писать код на C ++, так как он даст вам хороший обзор внутренних компонентов.
• Если вы собираетесь работать в C ++, сначала убедитесь, что вы можете без проблем скомпилировать FreeCAD.
• Презентуйте себя другим разработчикам. FreeCAD - это прежде всего социальный проект, мы обсуждаем многие вещи на форуме, прежде чем их реализовать, и всегда лучше обсудить свои идеи и рассказать людям, что вы планируете сделать, прежде чем сделать это на самом деле. У нас также есть IRC-канал [1], который синхронизирован с нашим каналом Matrix, а также канал Discord.
• С 2016 года FreeCAD также участвует в Летний код Google 2020. Не забудьте проверить наши идеи там, если вы заинтересованы в участии в следующем выпуске.
• Всё больше и больше функциональности FreeCAD написано не в самом коде FreeCAD, а в дополнениях, макросах и расширениях. В совокупности эта экосистема и делает FreeCAD мощным. Зачастую работа над дополнением проще, потому что меньше кода, который нужно читать и понимать, и меньше людей вовлечено в работу. Посмотрите Репозиторий дополнений и Репозиторий макросов, чтобы получить некоторые идеи!

Создавайте модели

В FreeCAD есть библиотека Models, которая бесплатна и открыта для всех. Почему бы не добавить туда несколько полезных компонентов, которые могли бы быть использованы другими? Обязательно создавайте модели сами с нуля, чтобы библиотека была на 100% свободна от возможных защищённых авторским правом или несвободных компонентов.